'\" e
'\"! eqn | mmdoc
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 24 September 1999
.ds Re Release 1.2.1
.ds Dp Jan 14 18:30
.ds Dm 01 genlists.
.ds Xs 2609 3 genlists.gl
.TH GLGENLISTS 3G
.SH NAME
.B "glGenLists
\- generate a contiguous set of empty display lists

.SH C SPECIFICATION
GLuint \f3glGenLists\fP(
GLsizei \fIrange\fP )
.nf
.fi

.SH PARAMETERS
.TP \w'\f2range\fP\ \ 'u 
\f2range\fP
Specifies the number of contiguous empty display lists
to be generated.
.SH DESCRIPTION
\%\f3glGenLists\fP has one argument, \f2range\fP.
It returns an integer \f2n\fP such that \f2range\fP contiguous
empty display lists,
named \f2n\fP, \f2n\fP+1, ..., \f2n\fP+\f2range\fP \-1,
are created.
If \f2range\fP is 0,
if there is no group of \f2range\fP contiguous names available,
or if any error is generated,
no display lists are generated,
and 0 is returned.
.SH ERRORS
\%\f3GL_INVALID_VALUE\fP is generated if \f2range\fP is negative.
.P
\%\f3GL_INVALID_OPERATION\fP is generated if \%\f3glGenLists\fP
is executed between the execution of \%\f3glBegin\fP
and the corresponding execution of \%\f3glEnd\fP.
.SH ASSOCIATED GETS
\%\f3glIsList\fP
.SH SEE ALSO
\%\f3glCallList(3G)\fP,
\%\f3glCallLists(3G)\fP,
\%\f3glDeleteLists(3G)\fP,
\%\f3glNewList(3G)\fP
